home *** CD-ROM | disk | FTP | other *** search
/ Chip 2007 January, February, March & April / Chip-Cover-CD-2007-02.iso / Pakiet bezpieczenstwa / mini Pentoo LiveCD 2006.1 / mpentoo-2006.1.iso / livecd.squashfs / usr / include / linux / qic117.h < prev    next >
C/C++ Source or Header  |  2005-10-13  |  12KB  |  291 lines
  1. #ifndef _QIC117_H
  2. #define _QIC117_H
  3.  
  4. /*
  5.  *      Copyright (C) 1993-1996 Bas Laarhoven,
  6.  *                (C) 1997      Claus-Justus Heine.
  7.  
  8.  This program is free software; you can redistribute it and/or modify
  9.  it under the terms of the GNU General Public License as published by
  10.  the Free Software Foundation; either version 2, or (at your option)
  11.  any later version.
  12.  
  13.  This program is distributed in the hope that it will be useful,
  14.  but WITHOUT ANY WARRANTY; without even the implied warranty of
  15.  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16.  GNU General Public License for more details.
  17.  
  18.  You should have received a copy of the GNU General Public License
  19.  along with this program; see the file COPYING.  If not, write to
  20.  the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
  21.  
  22.  *
  23.  * $Source: /homes/cvs/ftape-stacked/include/linux/qic117.h,v $
  24.  * $Revision: 1.2 $
  25.  * $Date: 1997/10/05 19:19:32 $
  26.  *
  27.  *      This file contains QIC-117 spec. related definitions for the
  28.  *      QIC-40/80/3010/3020 floppy-tape driver "ftape" for Linux.
  29.  *
  30.  *      These data were taken from the Quarter-Inch Cartridge
  31.  *      Drive Standards, Inc. document titled:
  32.  *      `Common Command Set Interface Specification for Flexible
  33.  *       Disk Controller Based Minicartridge Tape Drives'
  34.  *       document QIC-117 Revision J, 28 Aug 96.
  35.  *      For more information, contact:
  36.  *       Quarter-Inch Cartridge Drive Standards, Inc.
  37.  *       311 East Carrillo Street
  38.  *       Santa Barbara, California 93101
  39.  *       Telephone (805) 963-3853
  40.  *       Fax       (805) 962-1541
  41.  *       WWW       http://www.qic.org
  42.  *
  43.  *      Current QIC standard revisions (of interest) are:
  44.  *       QIC-40-MC,   Rev. M,  2 Sep 92.
  45.  *       QIC-80-MC,   Rev. N, 20 Mar 96.
  46.  *       QIC-80-MC,   Rev. K, 15 Dec 94.
  47.  *       QIC-113,     Rev. G, 15 Jun 95.
  48.  *       QIC-117,     Rev. J, 28 Aug 96.
  49.  *       QIC-122,     Rev. B,  6 Mar 91.
  50.  *       QIC-130,     Rev. C,  2 Sep 92.
  51.  *       QIC-3010-MC, Rev. F, 14 Jun 95.
  52.  *       QIC-3020-MC, Rev. G, 31 Aug 95.
  53.  *       QIC-CRF3,    Rev. B, 15 Jun 95.
  54.  * */
  55.  
  56. /*
  57.  *      QIC-117 common command set rev. J.
  58.  *      These commands are sent to the tape unit
  59.  *      as number of pulses over the step line.
  60.  */
  61.  
  62. typedef enum {
  63.     QIC_NO_COMMAND                  = 0,
  64.     QIC_RESET             = 1,
  65.     QIC_REPORT_NEXT_BIT        = 2,
  66.     QIC_PAUSE             = 3,
  67.     QIC_MICRO_STEP_PAUSE        = 4,
  68.     QIC_ALTERNATE_TIMEOUT        = 5,
  69.     QIC_REPORT_DRIVE_STATUS        = 6,
  70.     QIC_REPORT_ERROR_CODE        = 7,
  71.     QIC_REPORT_DRIVE_CONFIGURATION    = 8,
  72.     QIC_REPORT_ROM_VERSION        = 9,
  73.     QIC_LOGICAL_FORWARD        = 10,
  74.     QIC_PHYSICAL_REVERSE        = 11,
  75.     QIC_PHYSICAL_FORWARD        = 12,
  76.     QIC_SEEK_HEAD_TO_TRACK        = 13,
  77.     QIC_SEEK_LOAD_POINT        = 14,
  78.     QIC_ENTER_FORMAT_MODE        = 15,
  79.     QIC_WRITE_REFERENCE_BURST    = 16,
  80.     QIC_ENTER_VERIFY_MODE        = 17,
  81.     QIC_STOP_TAPE            = 18,
  82. /* commands 19-20: reserved */
  83.     QIC_MICRO_STEP_HEAD_UP        = 21,
  84.     QIC_MICRO_STEP_HEAD_DOWN    = 22,
  85.     QIC_SOFT_SELECT            = 23,
  86.     QIC_SOFT_DESELECT        = 24,
  87.     QIC_SKIP_REVERSE        = 25,
  88.     QIC_SKIP_FORWARD        = 26,
  89.     QIC_SELECT_RATE            = 27,
  90. /* command 27, in ccs2: Select Rate or Format */
  91.     QIC_ENTER_DIAGNOSTIC_1        = 28,
  92.     QIC_ENTER_DIAGNOSTIC_2        = 29,
  93.     QIC_ENTER_PRIMARY_MODE        = 30,
  94. /* command 31: vendor unique */
  95.     QIC_REPORT_VENDOR_ID        = 32,
  96.     QIC_REPORT_TAPE_STATUS        = 33,
  97.     QIC_SKIP_EXTENDED_REVERSE    = 34,
  98.     QIC_SKIP_EXTENDED_FORWARD    = 35,
  99.     QIC_CALIBRATE_TAPE_LENGTH    = 36,
  100.     QIC_REPORT_FORMAT_SEGMENTS    = 37,
  101.     QIC_SET_FORMAT_SEGMENTS        = 38,
  102. /* commands 39-45: reserved */
  103.     QIC_PHANTOM_SELECT        = 46,
  104.     QIC_PHANTOM_DESELECT        = 47
  105. } qic117_cmd_t;
  106.  
  107. typedef enum {
  108.     discretional = 0, required, ccs1, ccs2
  109. } qic_compatibility;
  110.  
  111. typedef enum {
  112.     unused, mode, motion, report
  113. } command_types;
  114.  
  115. struct qic117_command_table {
  116.     char *name;
  117.     __u8 mask;
  118.     __u8 state;
  119.     __u8 cmd_type;
  120.     __u8 non_intr;
  121.     __u8 level;
  122. };
  123.  
  124. #define QIC117_COMMANDS {\
  125. /* command                           mask  state cmd_type           */\
  126. /* |    name                         |     |     |       non_intr   */\
  127. /* |    |                            |     |     |       |  level   */\
  128. /* 0*/ {NULL,                        0x00, 0x00, mode,   0, discretional},\
  129. /* 1*/ {"soft reset",                0x00, 0x00, motion, 1, required},\
  130. /* 2*/ {"report next bit",           0x00, 0x00, report, 0, required},\
  131. /* 3*/ {"pause",                     0x36, 0x24, motion, 1, required},\
  132. /* 4*/ {"micro step pause",          0x36, 0x24, motion, 1, required},\
  133. /* 5*/ {"alternate command timeout", 0x00, 0x00, mode,   0, required},\
  134. /* 6*/ {"report drive status",       0x00, 0x00, report, 0, required},\
  135. /* 7*/ {"report error code",         0x01, 0x01, report, 0, required},\
  136. /* 8*/ {"report drive configuration",0x00, 0x00, report, 0, required},\
  137. /* 9*/ {"report rom version",        0x00, 0x00, report, 0, required},\
  138. /*10*/ {"logical forward",           0x37, 0x25, motion, 0, required},\
  139. /*11*/ {"physical reverse",          0x17, 0x05, motion, 0, required},\
  140. /*12*/ {"physical forward",          0x17, 0x05, motion, 0, required},\
  141. /*13*/ {"seek head to track",        0x37, 0x25, motion, 0, required},\
  142. /*14*/ {"seek load point",           0x17, 0x05, motion, 1, required},\
  143. /*15*/ {"enter format mode",         0x1f, 0x05, mode,   0, required},\
  144. /*16*/ {"write reference burst",     0x1f, 0x05, motion, 1, required},\
  145. /*17*/ {"enter verify mode",         0x37, 0x25, mode,   0, required},\
  146. /*18*/ {"stop tape",                 0x00, 0x00, motion, 1, required},\
  147. /*19*/ {"reserved (19)",             0x00, 0x00, unused, 0, discretional},\
  148. /*20*/ {"reserved (20)",             0x00, 0x00, unused, 0, discretional},\
  149. /*21*/ {"micro step head up",        0x02, 0x00, motion, 0, required},\
  150. /*22*/ {"micro step head down",      0x02, 0x00, motion, 0, required},\
  151. /*23*/ {"soft select",               0x00, 0x00, mode,   0, discretional},\
  152. /*24*/ {"soft deselect",             0x00, 0x00, mode,   0, discretional},\
  153. /*25*/ {"skip segments reverse",     0x36, 0x24, motion, 1, required},\
  154. /*26*/ {"skip segments forward",     0x36, 0x24, motion, 1, required},\
  155. /*27*/ {"select rate or format",     0x03, 0x01, mode,   0, required /* [ccs2] */},\
  156. /*28*/ {"enter diag mode 1",         0x00, 0x00, mode,   0, discretional},\
  157. /*29*/ {"enter diag mode 2",         0x00, 0x00, mode,   0, discretional},\
  158. /*30*/ {"enter primary mode",        0x00, 0x00, mode,   0, required},\
  159. /*31*/ {"vendor unique (31)",        0x00, 0x00, unused, 0, discretional},\
  160. /*32*/ {"report vendor id",          0x00, 0x00, report, 0, required},\
  161. /*33*/ {"report tape status",        0x04, 0x04, report, 0, ccs1},\
  162. /*34*/ {"skip extended reverse",     0x36, 0x24, motion, 1, ccs1},\
  163. /*35*/ {"skip extended forward",     0x36, 0x24, motion, 1, ccs1},\
  164. /*36*/ {"calibrate tape length",     0x17, 0x05, motion, 1, ccs2},\
  165. /*37*/ {"report format segments",    0x17, 0x05, report, 0, ccs2},\
  166. /*38*/ {"set format segments",       0x17, 0x05, mode,   0, ccs2},\
  167. /*39*/ {"reserved (39)",             0x00, 0x00, unused, 0, discretional},\
  168. /*40*/ {"vendor unique (40)",        0x00, 0x00, unused, 0, discretional},\
  169. /*41*/ {"vendor unique (41)",        0x00, 0x00, unused, 0, discretional},\
  170. /*42*/ {"vendor unique (42)",        0x00, 0x00, unused, 0, discretional},\
  171. /*43*/ {"vendor unique (43)",        0x00, 0x00, unused, 0, discretional},\
  172. /*44*/ {"vendor unique (44)",        0x00, 0x00, unused, 0, discretional},\
  173. /*45*/ {"vendor unique (45)",        0x00, 0x00, unused, 0, discretional},\
  174. /*46*/ {"phantom select",            0x00, 0x00, mode,   0, discretional},\
  175. /*47*/ {"phantom deselect",          0x00, 0x00, mode,   0, discretional},\
  176. }
  177.  
  178. /*
  179.  *      Status bits returned by QIC_REPORT_DRIVE_STATUS
  180.  */
  181.  
  182. #define QIC_STATUS_READY    0x01    /* Drive is ready or idle. */
  183. #define QIC_STATUS_ERROR    0x02    /* Error detected, must read
  184.                        error code to clear this */
  185. #define QIC_STATUS_CARTRIDGE_PRESENT 0x04    /* Tape is present */
  186. #define QIC_STATUS_WRITE_PROTECT 0x08    /* Tape is write protected */
  187. #define QIC_STATUS_NEW_CARTRIDGE 0x10    /* New cartridge inserted, must
  188.                        read error status to clear. */
  189. #define QIC_STATUS_REFERENCED    0x20    /* Cartridge appears to have been
  190.                        formatted. */
  191. #define QIC_STATUS_AT_BOT    0x40    /* Cartridge is at physical
  192.                        beginning of tape. */
  193. #define QIC_STATUS_AT_EOT    0x80    /* Cartridge is at physical end
  194.                        of tape. */
  195. /*
  196.  *      Status bits returned by QIC_REPORT_DRIVE_CONFIGURATION
  197.  */
  198.  
  199. #define QIC_CONFIG_RATE_MASK    0x18
  200. #define QIC_CONFIG_RATE_SHIFT    3
  201. #define QIC_CONFIG_RATE_250    0
  202. #define QIC_CONFIG_RATE_500    2
  203. #define QIC_CONFIG_RATE_1000    3
  204. #define QIC_CONFIG_RATE_2000    1
  205. #define QIC_CONFIG_RATE_4000    0       /* since QIC-117 Rev. J */
  206.  
  207. #define QIC_CONFIG_LONG        0x40    /* Extra Length Tape Detected */
  208. #define QIC_CONFIG_80        0x80    /* QIC-80 detected. */
  209.  
  210. /*
  211.  *      Status bits returned by QIC_REPORT_TAPE_STATUS
  212.  */
  213.  
  214. #define QIC_TAPE_STD_MASK       0x0f
  215. #define QIC_TAPE_QIC40      0x01
  216. #define QIC_TAPE_QIC80      0x02
  217. #define QIC_TAPE_QIC3020      0x03
  218. #define QIC_TAPE_QIC3010      0x04
  219.  
  220. #define QIC_TAPE_LEN_MASK    0x70
  221. #define QIC_TAPE_205FT        0x10
  222. #define QIC_TAPE_307FT        0x20
  223. #define QIC_TAPE_VARIABLE    0x30
  224. #define QIC_TAPE_1100FT        0x40
  225. #define QIC_TAPE_FLEX        0x60
  226.  
  227. #define QIC_TAPE_WIDE        0x80
  228.  
  229. /* Define a value (in feet) slightly higher than 
  230.  * the possible maximum tape length.
  231.  */
  232. #define QIC_TOP_TAPE_LEN    1500
  233.  
  234. /*
  235.  *      Errors: List of error codes, and their severity.
  236.  */
  237.  
  238. typedef struct {
  239.     char *message;        /* Text describing the error. */
  240.     unsigned int fatal:1;    /* Non-zero if the error is fatal. */
  241. } ftape_error;
  242.  
  243. #define QIC117_ERRORS {\
  244.   /* 0*/ { "No error", 0, },\
  245.   /* 1*/ { "Command Received while Drive Not Ready", 0, },\
  246.   /* 2*/ { "Cartridge Not Present or Removed", 1, },\
  247.   /* 3*/ { "Motor Speed Error (not within 1%)", 1, },\
  248.   /* 4*/ { "Motor Speed Fault (jammed, or gross speed error", 1, },\
  249.   /* 5*/ { "Cartridge Write Protected", 1, },\
  250.   /* 6*/ { "Undefined or Reserved Command Code", 1, },\
  251.   /* 7*/ { "Illegal Track Address Specified for Seek", 1, },\
  252.   /* 8*/ { "Illegal Command in Report Subcontext", 0, },\
  253.   /* 9*/ { "Illegal Entry into a Diagnostic Mode", 1, },\
  254.   /*10*/ { "Broken Tape Detected (based on hole sensor)", 1, },\
  255.   /*11*/ { "Warning--Read Gain Setting Error", 1, },\
  256.   /*12*/ { "Command Received While Error Status Pending (obs)", 1, },\
  257.   /*13*/ { "Command Received While New Cartridge Pending", 1, },\
  258.   /*14*/ { "Command Illegal or Undefined in Primary Mode", 1, },\
  259.   /*15*/ { "Command Illegal or Undefined in Format Mode", 1, },\
  260.   /*16*/ { "Command Illegal or Undefined in Verify Mode", 1, },\
  261.   /*17*/ { "Logical Forward Not at Logical BOT or no Format Segments in Format Mode", 1, },\
  262.   /*18*/ { "Logical EOT Before All Segments generated", 1, },\
  263.   /*19*/ { "Command Illegal When Cartridge Not Referenced", 1, },\
  264.   /*20*/ { "Self-Diagnostic Failed (cannot be cleared)", 1, },\
  265.   /*21*/ { "Warning EEPROM Not Initialized, Defaults Set", 1, },\
  266.   /*22*/ { "EEPROM Corrupted or Hardware Failure", 1, },\
  267.   /*23*/ { "Motion Time-out Error", 1, },\
  268.   /*24*/ { "Data Segment Too Long -- Logical Forward or Pause", 1, },\
  269.   /*25*/ { "Transmit Overrun (obs)", 1, },\
  270.   /*26*/ { "Power On Reset Occurred", 0, },\
  271.   /*27*/ { "Software Reset Occurred", 0, },\
  272.   /*28*/ { "Diagnostic Mode 1 Error", 1, },\
  273.   /*29*/ { "Diagnostic Mode 2 Error", 1, },\
  274.   /*30*/ { "Command Received During Non-Interruptible Process", 1, },\
  275.   /*31*/ { "Rate or Format Selection Error", 1, },\
  276.   /*32*/ { "Illegal Command While in High Speed Mode", 1, },\
  277.   /*33*/ { "Illegal Seek Segment Value", 1, },\
  278.   /*34*/ { "Invalid Media", 1, },\
  279.   /*35*/ { "Head Positioning Failure", 1, },\
  280.   /*36*/ { "Write Reference Burst Failure", 1, },\
  281.   /*37*/ { "Prom Code Missing", 1, },\
  282.   /*38*/ { "Invalid Format", 1, },\
  283.   /*39*/ { "EOT/BOT System Failure", 1, },\
  284.   /*40*/ { "Prom A Checksum Error", 1, },\
  285.   /*41*/ { "Drive Wakeup Reset Occurred", 1, },\
  286.   /*42*/ { "Prom B Checksum Error", 1, },\
  287.   /*43*/ { "Illegal Entry into Format Mode", 1, },\
  288. }
  289.  
  290. #endif                /* _QIC117_H */
  291.